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INTRODUCTION 


This AST-5250 Emulation Program Supplement provides 
additional configuration and operational features for the AST-5250 
product line. This supplement is an addition to the information 
covered in the current version of the User’s Manual in your 
AST-5250 terminal emulation package. 

Personal Computer (PC) is used often throughout this 
supplement as a generic term when referencing your PC, as well 
as your Personal System/2 ™ (PS/2), and Workstation (WS). 

FEATURES 

The following features have been added to the AST-5250 product 
line: 

• Application Presentation Services (APS) Window 
Manager Support. Provides concurrently displayed 
window sessions. All visible emulation sessions are 
continuously updated. 

• AST Keyboard Utility (ASTKBD). Conserves disk space 
by compressing all related keyboard files into one file 
with a .CMP extension. This feature enables you to 
support any number of countries, any number of 
keyboard styles for that country, and have all of your 
menu options displayed in the language of your choice. 

• 122-Key Keyboard Support. Enables you to use a 
122-key keyboard. 
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• IBM Application Program Interface (API) Support. 

Enables you to emulate multiple sessions while in IBM 
API mode. 

• Enhanced Graphics Adapter (EGA) Support. Gives you 
column separators, and graphic screen restoration during 
hot-key with EGA video adapter. 

• Video Graphics Array (VGA). Gives you column 
separators, and graphic screen restoration during hot-key 
with VGA video adapter. 

• IBM 3180 Support. Supports aii iBM 3180 attributes. 
Featuring a wider screen with 27 iines by 132 columns, 
when using the AST Preview i/0 display adapter. This 
feature is availabie for your localiy attached 
communications system. 

Async Dial-up, Cluster and Gateway only: 

• Local Echo. Provides a visuai display of your keyboard 
entry before the host system receives the scan code 
entered from your keyboard. 

Cluster and Async Dial-up only: 

• Encryption Keys. Provides a high level of security when 
data is being transmitted. 

• Terminal Support. Provides IBM 3151, Digital Equipment 
Corporation VT-100 ™, and compatible terminal support 
while using the configuration program. 

The features and new configuration items are described in the 

foliowing sections. 
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APS WINDOW MANAGER 1 


The APS Window Manager provides muiti-session support. The 
singie foreground session is interactive and affected by your 
keystrokes, with all visible sessions being continuously updated. 

You control your screen configuration (size, location, color, and 
number of displayed windows). The currently defined limit is 
seven windows. The actual number of windows available 
depends on the number of communication sessions configured. 

You can save and recall up to nine user-definable screen 
configurations (profiles). 

Each window can be reduced in size to allow concurrent displays. 
The foreground session can be "zoomed" at any time to occupy 
the entire screen. The system remains in zoom mode showing 
each window as a full screen until you "unzoom". For example, 
hot-keying between various sessions displays each window as a 
full screen until you change modes ("unzoom"). 
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1.1 Window Manager Display Adapter Support 

The Window Manager supports the following adapters: 

• Monochrome display adapter (MDA). 

• Color graphics adapter (CGA). 

• Enhanced graphics adapter (EGA) and AST-3G. 

• Video graphics array (VGA). 

• AST Preview I/O adapter. 

• AST-5250/display ™ adapter. 

Column separators and field attributes are provided for the 
AST-5250/clisplay adapter, a monochrome graphics adapter that 
supports 5250 display attributes. 

AST-5250 terminal emulation supports color attributes if a color 
monitor and color graphics display adapter are installed in your 
system. 

Column separators are fully supported for EGA color and VGA 
color display adapters only. However, column separator 
replacement characters are provided for other display adapters 

Refer to yoor AST-5250/Emulation Program Base Manual for a 
detailed description of the various aspects of window 
management. 
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KEYBOARD SUPPORT 2 


The new ASTKBD program (ASTKBD.EXE) includes more features 
and conserves disk space. ASTKBD supports most international 
keyboards and keyboard types. It enables you to select an 
international keyboard type to emulate the host keyboard 
functions. ASTKBD copies this information to the AST5251 .KBD 
file. Your AST5251 .KBD file is read by the emulation program 
while you are loading emulation. 


2.1 Loading ASTKBD 

This section tells you how to extract a keyboard file for the 
specific country and keyboard type you are using. First you must 
identify the country, and the keyboard style you are using. 

AST has provided two 5.25-inch and/or one 3.5-inch emulation 
software diskettes, depending on the emulation product you are 
using. The KBD subdirectory is on Disk 2 of 2 for two diskette 
distributions. 

You should have already made back-up copies of your emulation 
software. If you do not have back-up copies of your emulation 
software, follow the instructions given in your 
AST-5250 Emulation Program Base Manual. 

Insert your back-up copy of the diskette containing the KDB 
subdirectory into diskette drive A. 

Make diskette drive A: your default drive, and root as your default 
directory. Enter: 


A: < Enter > 
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Enter the following command to display Figure 2-1, the Keyboard 
Specifications menu: 

ASTKBD< Enter > 

The following screen displays: 



AST Research Inc. 

Copyright (c) 1987 AST Research Inc. 
All Rights Reserved 




Operation: 

Country: 

Keyboard: 


Extract 
Austria 
5250 Like 


Proceed 
Exit to DOS 


V 


Select the Operation by using the arrow keys: 



Figure 2-1. Keyboard Specifications Menu. 
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2.2 Using the Keys 

The following sections discuss the Keyboard Specifications menu 
parameter options. 

Country Parameter Options 

The Country parameter line displays the countries available. The 
options available are; 


Austria 

International 

Belgium 

Italy 

Brazil 

Japan 

Canada 

Norway 

Denmark 

Portugal 

Finland 

Spain 

France 

Sweden 

Germany 

Switzerland 

Greece 

United Kingdom 

IBM 

United States 

Iceland 



Keyboard Parameter Options 

The Keyboard parameter line displays the keyboard styles 
available for the country you select. The options available are: 

5250 like 
PC like 
AT like 

Enhanced like 
Irma 122 
Keytronics 122 


NOTE 

All keyboard styles are not available for all countries. 
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Follow the steps below to select your country and keyboard style. 

STEP 1 ) 

Position your cursor: Press the < Down Arrow > to move the 
cursor to the Country parameter. The following message appears 
at the bottom of your screen: 

Select the country by using the arrow keys 


STEP 2 

identify the country: Press the < Left Arrow > 

or < Right Arrow > to select the country that you are supporting. 

STEP 3 

Seiect your keyboard type: Press the < Down Arrow > to move 
the cursor to the Keyboard parameter. The following message 
appears at the bottom of your screen: 

Select the keyboard type by using the arrow keys 

Press the < Left Arrow > or < Right Arrow > to select your 
keyboard type. 

STEP 4 

Continue the operation: Press the < Down Arrow > to move the 
cursor to Proceed. The following message appears at the bottom 
of your screen: 

Proceeds with the operation with specified values 

Press < Enter > to run the emulation program using the country 
and/or keyboard style that you selected in Steps 1 through 3. The 
following prompt appears in the center of your screen: 

Enter drive and subdirectory for target file: 

Enter the complete drive and directory where your emulation 
program fifes reside. 
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NOTE 

For the input and output file name, AST 
recommends giving the full pathname including 
the drive. You can only add one input file name 
and the keyboard type from the command line. 


STEPS 

Exit the program: Press < Enter > with the cursor on Ex/f fo DOS 
to returns to DOS. 

Pressing <Esc> exits to the previous status. Pressing <Esc> 
again returns you to the Keyboard Specifications menu. Pressing 
< Esc > three times exits you to DOS. 

Pressing < Enter > on other lines within the menu causes the 
program to beep. 
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NOTES 

O 


o 


o 
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ADDITIONAL 

CONFIGURATION OPTIONS 3 


The following sections provide additional configuration options for 
your AST-5250 terminal emulation program. Each task and its 
new option(s) are discussed in these sections. Occasionally you 
will see a task enclosed in parenthesis, this enclosure indicates 
where the task referenced can be found in your user’s manual. 

Pressing < Right Arrow > or < Left Arrow > selects the desired 
tasks and options. 


3.1 Hardware Tasks 

The Hardware tasks provide instructions for configuring your 
twinax adapter board’s hardware and display adapter(s), enabling 
you to select the display adapter card type. You can now select 
EGA, VGA, or Preview I/O as an adapter type for PCs. EGA is the 
only new option available for PS/2s. The following menu line 
displays when you select DSP ADAPTER: 

For PC: 

ADAPTER_CARDS MONO COLOR PREVIEW PREVIEW_l/0 5250/DSP 
EGA VGA QUIT 


ForPSl2: 

ADAPTER CARDS VGA MONO COLOR EGA QUIT 

Select the parameter you want set and press < Enter >. Follow 
any additional instructions as they appear on your screen. 
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3.2 Station Tasks 

The Station (ST) tasks enable you to configure station 
parameters. When you select a display device (ST TASK 2), you 
are required to select the type of display. The following menu line 
displays when you select DISPLAY (ST TASK 3), CLUS DISPLAY 
(ST TASK 43), or GATE_DISPLAY (ST TASK 45): 

5251/11 5291 5292-1 3180 QUIT 

Select a display type and press < Enter >. Go to one of the 
following tasks: 

ST TASK 3 - DISPLAY 

ST TASK 42 - CLUS_DISPLAY 

ST TASK 45 - GATE DISPLAY 


3.3 Customize Tasks 

The Customize (CZ) tasks provide instructions for customizing 
your keyboard. You can remap special keys using the Select 
Keyboard Remap Function menu (CZ TASK 2). Select 
REMAP JTBLS, then Special. When you select the SPECIAL 
opfion, the following menu line displays: 

CONTROL_KEYS EXTRA OVERRUN FUNCTION_KEYS COMMAND_KEYS WHITE_KEYS QUIT 


ST TASK 4 
ST TASK 4 
ST TASK 1 


The following sections discuss the parameters that are available 
when you select the Special option. 

Select the parameter you want set and follow any additional 
instructions as they appear on your screen. 
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3.3.1 CONTROL_KEYS 


o 


Task Objective: Remap predefined control keys. 


Task Explanation: Reassign a particular control function to 
another key. This task is especially useful for remapping 
international keyboards or control keys whose function interferes 
with normal operation (for exarnple, DESQview’s < Alt> key). 


Each keyboard has a set of control keys that perform special 
functions when pressed with another key. For example, 

< Left Shift > - < Right Shift > is the hot key sequence. This task 
allows you to change which keys perform the control functions. 


Procedure: 



1. Select the CONTROL KEYS option. Figure 3-1 shows the 
default control key and scan code list that displays: 
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N 

Control Function Scan Code Control Function Scan Code 


1. 

Esc 

1 

12. 

Num 

Pad 1 

4F 

2. 

Alt 

38 

13. 

Num 

Pad 2 

50 

3. 

Ctrl 

ID 

14. 

Num 

Pad 3 

51 

4. 

Left Shift 

2A 

15. 

Num 

Pad 4 

4B 

5. 

Right Shift 

36 

16. 

Num 

Pad 5 

4C 

6. 

Num Lock 

45 

17. 

Num 

Pad 6 

4D 

7. 

PrtSc 

37 

18. 

Num 

Pad 7 

47 

8. 

Del 

53 

19. 

Num 

Pad 8 

48 

9. 

Brk 

46 

20. 

Num 

Pad 9 

49 

10. 

Ctl-C 

2E 

21. 

Invoke Macro 

38 

11. 

Num Pad 0 

52 






_ j 

Figure 3-1. Control Key and Scan Code List. 


2. Enter the number (1 through 21) indicating which control 
function you want to change and press < Enter >. For 
example, to change < Alt > - < Num Pad 2 > (the direct 
access hot-key sequence for session 2) to < Alt > - < Q >, 
you would select the number 13. The following prompt 
displays: 

Enter the PC scan code for the the key you want assigned to this control function 
(or <Esc> to exit): 
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3. Enter the PC scan code for the new key (see the 
AST-5250/Emulation Program Base Manual) and press 
< Enter >. For this example enter < 16> , the PC scan 
code for the letter "q". The new scan code displays on 
your screen. 

4. Press < Esc > and go to CZ TASK 2. 


3.3.2 EXTRA 

Task Objective: Assign new values to "extra scan codes". This 
task is required to use emulation with 122-key keyboards. 

Figure 3-2 shows the 122-key keyboard type. 
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Q ID 


O ^[3 E 



Figure 3-2. 122-key Keyboard. 
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Task Explanation: Several keyboard types have more keys than 
the standard PC keyboard. Scan codes for the "extra" keys are 
handled differently depending on the keyboard type. 

In particular, the extra keys on the enhanced keyboard send two 
(rather than one) scan codes when pressed. The first scan code 
is always either OEOh or 0E1 h, depending on the key. The second 
scan code has a different value for each key. 

By default, the AST5251.KBD file includes the values "OEOh" and 
"OEIh" as codes to be sent when an extra key is pressed. This is 
appropriate for either the enhanced or standard PC keyboard 
(because an extra key cannot be pressed on a standard 
keyboard, these values are never sent). However, these values 
should not be sent for the 122-key keyboards. To use emulation 
with the 122-key keyboard, set these values to zero, by 
completing the following procedure. 

Procedure: 

1. Select the EXTRA option. The following prompt displays: 

Current extra code value #1 is:eO 
Current extra code value #2 is:eO 

Enter extra code value #1 (hex value): 

2. Enter < 0 > and press < Enter >. This tells the system 
not to send the OEOh extra code when an extra key is 
pressed. Once you have entered an appropriate 
response, the following prompt displays: 

Enter extra code value #2 (hex value): 
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3. After the second prompt, enter < 0 > and press 

< Enter >. This tells the system not to send the 0E1 h 
extra code when an extra key is pressed. 

NOTE 

The configuration program enables you to enter 
any appropriate values (not just zero) you want 
for these extra scan codes. The values you enter 
are sent instead of the OEOh or 0Elh codes. This 
feature is provided to support unusual or future 
keyboards that may require it. 


3.3.3 OVERRUN 

Task Objective: Assign a new value to the scan code indicating 
that keyboard overrun has occurred. This is required to use 
emulation with the 122-key keyboard. 

Task Explanation: If you type faster than the system can process 
characters, the standard keyboard sends a scan code with the 
value OFFh to indicate that "keyboard overrun" has occurred. The 
122-key keyboard uses OFFh as a scan code for one of its keys, 
and does not have an overrun character. To use emulation with a 
122-key keyboard, change the overrun value from OFFh to OOh. 
(OOh indicates no overrun character.) 

Procedure: 

1. Select the OVERRUN option, and the following prompt 
displays: 

Current keyboard overrun scan code is: ff 


Enter new keyboard overrun scan code (hex value): 
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O 


2. Enter the appropriate hex value you want for keyboard 
overrun. You would not normally enter any value other 
than OFFh or OOh. 


NOTE 

This task supports future or unusual keyboards. 


3.3.4 FUNCTION_KEYS 

Task Objective: Reassign a predefined "function" of standard 
5250 function keys to another key. This task exists primarily to 
support 122-key keyboards. 

Task Explanation: Some functions, such as setting the printer 
on-line, are initiated by pressing a 5250 function key when the 
Main menu screen is displayed. This task enables you to reassign 
a particular 5250 function key function to another key. Because 
the 122-key keyboard has two sets of function keys, this task can 
reassign a function from a 5250 function key to a 122-key 
keyboard function key. 

Procedure: 

1. Select the FUNCTION KEYS option. Figure 3-3 shows 
the default function and scan code list that displays: 


o 
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r 




Function Key 

Scan Code 

1. Fn key 1 

3B 

2. Fn key 2 

3C 

3. Fn key 3 

3D 

4. Fn key 4 

3E 

5. Fn key 5 

3F 


Function Key 

Scan Code 

6. Fn key 6 

40 

7. Fn key 7 

41 

8. Fn key 8 

42 

9. Fn key 9 

43 

10. Fn key 10 

44 



Enter number (1-10) Indicating which funtion key you want to change 
(or press' < Esc > to exit): 


J 


Figure 3-3. Function Key and Scan Code List. 
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2. Enter the number (1 through 10) indicating which 

function to reassign and press < Enter >. The following 
prompt displays: 

Enter PC scan code for the key you want assigned to the function key (or < Esc> to exit) 


3. Enter the desired key’s PC scan code (see the 
AST-5250/Emulation Program Base Manual for PC scan 
codes). When the key is pressed at the Main menu, the 
corresponding function is initiated. Press < Enter >, or 
< Esc > to exit. 

4. To map another function key, return to step 2. 

5. Press < Esc > and go to CZ TASK 2. 


3.3.5 COMMAND_KEYS 

Task Objective: Remap predefined command keys. Redefine 
which PC keys act as 5250 command keys. This is useful 
primarily for 122-key keyboards. 

Task Explanation: Each keyboard has a set of keys assigned 
command functions. This task enabies you to change which PC 
keys perform command functions. 

Procedure: 

1. Select the COMMAND KEYS option. Figure 3-4 shows 
the defauit command key and scan code list that 
dispiays: 
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Command Key Scan Code 


Command Key Scan Code 


1. 

Command 1 

2 

2. 

Command 2 

3 

3. 

Command 3 

4 

4. 

Command 4 

5 

5. 

Command 5 

6 

6. 

Command 6 

7 


7. Command 7 8 

8. Command 8 9 

9. Command 9 A 

10. Command 10 B 

11. Command 11 C 

12. Command 12 D 




Enter number (1-12) indicating which command key you want to change (or 
press <Esc> to exit): 


Figure 3-4. Command Key and Scan Code List. 
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2. Enter the number (1 through 12) indicating which 

command key you want to change and press < Enter >. 

For exampie, to change < Command 1 > you would 
select < 1 >. The following prompt displays; 

Enter PC scan code for the key you want assigned to the command key (or < Esc> to exit). 


3. Enter the PC scan code for the new key (see the 
AST-5250/Emulation Program Base Manual) and press 

< Enter >. 

4. Press < Esc > and go to CZ TASK 2. 


3.3.6 WHITE_KEYS 

Task Objective: Redefine which PC keys are defined as "white 
keys" on the 5250 keyboard. This task is useful primarily for 
122-key keyboards. 

Task Explanation: White keys are all the alpha keys. Other keys 
(function keys, cursor keys, keypad, top row numerics) are "dark 
keys". Some white keys on the 122-key keyboard send scan 
codes with a different meaning than the same scan code on a 
standard keyboard. For example, the scan code OFFh sent from 
a 122-key keyboard is interpreted as a valid code. On the 
standard 5250 keyboard, OFFh indicates keyboard overrun has 
occurred. The WHITE KEYS option enables you to indicate 
codes that have different meaning than a standard 5250 
keyboard. 

Procedure: 

1. Select the WHITE KEYS option. Figure 3-5 shows the 
default byte number and value list that displays: 


23 





AST-5250 Emulation Program 



A 


Byte Number 

Byte Value 

1. Byte 1 

FF 

2. Byte 2 

3F 

3. Byte 3 

FF 

4. Byte 4 

CF 

5. Byte 5 

FF 

6. Byte 6 

FB 

7. Byte 7 

3F 

8. Byte 8 

0 


Byte Number Byte Value 

9. Byte 9 0 

10. Byte 10 0 

11. Byte 11 0 

12. Byte 12 0 

13. Byte 13 0 

14. Byte 14 0 

15. Byte 15 0 

16. Byte 16 0 


Enter number (1-16) indicating which byte you want to change 
(or press < Esc> to exit): 


Figure 3-5. Byte Number and Value List. 


2. Enter a number (1 through 16) indicating which byte you 
want changed and press < Enter >, or press < Esc > to 
exit. If a number is entered, the following prompt 
displays: 

Enter hex value for this byte:_ 
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3. Enter the desired value and press < Enter >. 

4. Press < Esc > and go to CZ TASK 2. 

3.4 Cluster and Gateway Tasks 

This section provides configuration updates for your 
AST-5250/Cluster and AST-5250/Gateway. 


3.4.1 Encryption Keys 

Encryption keys are available for cluster and async dial-up only. 

Task Objective: Encrypt data that is transmitted between the 
master and slave PC, making on-line eavesdropping difficult to 
decipher. 

Task Explanation: Your encryption key can be up to 10 
characters, assigned on a per port basis. Each port on the 
cluster PC can have its own encryption key, however, the slave 
PC encryption key must match the port that it is attached to on 
the master PC. 

Procedure: 

1. Select PORTS, the port number, then COMPORT. The 
following menu line displays; 

BAUD DATA STOP PARITY DEVICE COMLINE ENCRYPTIONKEY QUIT 


2 . 


3. 


Select ENCRYPTIONKEY, the following prompt displays: 
Enter new encryption sequence for port # = = > 

Enter new sequence and press < Enter >. 
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3.4.2 Local Echo 

Local Echo is available for async dial-up, cluster, and gateway 
only. 

Task Objective: Improve visual character response by displaying 
your keyboard entries before the host system receives the actual 
key corresponding to the scan code entered from the keyboard. 

Task Explanation: Local echo is switched on and off while you 
are in emulation mode. Press < Alt > - < Shift > to display the 
Main menu. To turn local echo on with lowercase echo, position 
the cursor over the local echo line and press < Enter >. Press 

< Enter > again to change local echo to uppercase. Pressing 

< Enter > again turns local echo off. Press < Esc > to exit the 
Main menu. 

Using the default translation table with lowercase on, echoes 
lowercase characters. Using the default translation table with 
uppercase on, echoes uppercase characters. 

You can run the configuration program to remap default local 
echo characters. Remapping is done to ensure compatibility 
between 5250 scan code characters and host system default 
characters. Depending on the application used, you can change 
the local echo display character to match the host system 
character. For example, C1 is the EBCDIC character code for 
uppercase A. C2 is the EBCDIC character code for uppercase B. 
The 5250 scan code for uppercase A is 11. This 5250 scan code 
(11) can be remapped to display uppercase B. 

The following procedure is an example of how to remap 5250 
scan code character code 11 from EBCDIC character code Cl 
(uppercase A) to C2 (uppercase B). 
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Procedure: 

1. Select REMAPJAASKJBLS from the CUSTOMIZE task. 

2. Position the cursor over UPPER SC_EBCDIC. Press 

< Enter >. Figure 3-6 shows the Uppercase Scan Code 
to EBCDIC Translation Table that appears. 


o 


Rrst Hexadecimal Character of 5250 Scan Code Character Set 



Ox 

lx 

2x 

3x 

4x 

5x 

6x 

7x 

xO 

00 

00 

00 

00 

00 

00 

00 

00 

x1 

E9 

C1 

D8 

4F 

00 

00 

00 

00 

x2 

E7 

E2 

E6 

7C 

00 

00 

00 

00 

x3 

C3 

C4 

C5 

7B 

00 

00 

00 

00 

x4 

E5 

C6 

D9 

5B 

00 

00 

00 

00 

x5 

C2 

C7 

E3 

6C 

00 

00 

00 

00 

x6 

D5 

C8 

E8 

5F 

00 

00 

00 

00 

x7 

D4 

D1 

E4 

50 

00 

00 

00 

00 

x8 

6B 

D2 

C9 

5C 

00 

00 

00 

00 

x9 

4B 

D3 

D6 

4D 

00 

00 

00 

00 

xA 

6F 

7A 

D7 

5D 

00 

00 

00 

00 

xB 

00 

7F 

5A 

6D 

00 

00 

00 

00 

xC 

00 

DO 

6A 

4E 

00 

00 

00 

00 

xD 

00 

00 

00 

00 

00 

00 

00 

00 

xE 

6E 

00 

A1 

00 

00 

00 

00 

00 

xF 

00 

00 

00 

00 

00 

00 

00 

00 



Figure 3-6. Uppercase Scan Code to EBCDIC 
Translation Table 
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AST-5250 Emulation Program 


3. At the prompt (located at the bottom of your screen) 
enter < 11 >. A second prompt displays requesting the 
EBCDIC character code for scan code 11: 

Enter EBCDIC character code for the scan code (11) in hex = = > 

4. Enter < C2 >. In the table, notice that scan code postlon 
11 is now C2. The first prompt appears requesting input 
for other 5250 scan code characters that you want 
changed: 

Enter 2 digit hex 5250 scan code character code to change = = > 

5. Enter the next scan code character code that you want 
changed, or press <Esc> to continue. 

If the character that Is locally echoed is not the actual key, the 
host system updates the screen with the correct value. 

NOTE 

AST recommends using Local echo with IBM API 
off for best performance. 


I 
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Supplement 


NOTES 

O 



O 
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